home *** CD-ROM | disk | FTP | other *** search
/ Hand Picked Software / Hand Picked Software.iso / applicat / catalg40 / manual.doc < prev    next >
Text File  |  1995-03-13  |  97KB  |  2,456 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                               Catalog-On-A-Disk 
  8.  
  9.                                   Version 4
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.                          The Selling Tool of the 90s
  46.  
  47.  
  48.              Published by EmmaSoft Software Company, Incorporated
  49.                          Copyright 1991-1994, EmmaSoft
  50.  
  51. CATALOG-ON-A-DISK is a trademark of EmmaSoft Software Company, Inc.
  52. Page i
  53. ----------------------------------------------------------------------
  54.  
  55.                           Table of Contents
  56.  
  57. LICENSE AGREEMENT AND WARRANTY  . . . . . . . . . . . . . .  ii
  58.  
  59. CHAPTER ONE: Quick Start Guide Setup and Tutorials. . . . . . 1
  60.  
  61. CHAPTER TWO: All About Catalogs . . . . . . . . . . . . . . . 4
  62.  
  63. CHAPTER THREE: Parts of a Catalog . . . . . . . . . . . . . . 5
  64.  
  65. CHAPTER FOUR: Catalog Features. . . . . . . . . . . . . . . . 7
  66.  
  67. CHAPTER FIVE: Catcom: Making A Catalog. . . . . . . . . . . .10
  68.  
  69. CHAPTER SIX: Alphabetical Features Reference. . . . . . . . .18
  70.      Address Setup (Name Box) . . . . . . . . . . . . . . . .18
  71.      Asking Extra Order Form Questions. . . . . . . . . . . .18
  72.      Category Files (Products, Descriptions, Coupons) . . . .19
  73.      CD-ROM Catalogs. . . . . . . . . . . . . . . . . . . . .21
  74.      Colors and Macros. . . . . . . . . . . . . . . . . . . .21
  75.      Command Files. . . . . . . . . . . . . . . . . . . . . .24
  76.      Configuration Files. . . . . . . . . . . . . . . . . . .24
  77.      Dealer Discounts . . . . . . . . . . . . . . . . . . . .25
  78.      Discount Multiplier. . . . . . . . . . . . . . . . . . .26
  79.      Exit Menu Screen (Catalog Insert). . . . . . . . . . . .27
  80.      Expired Prices . . . . . . . . . . . . . . . . . . . . .27
  81.      First Screens (Catalog Cover). . . . . . . . . . . . . .27
  82.      Freight. . . . . . . . . . . . . . . . . . . . . . . . .28
  83.      Help Screens . . . . . . . . . . . . . . . . . . . . . .28
  84.      Information Screen . . . . . . . . . . . . . . . . . . .28
  85.      Last and Special Orders. . . . . . . . . . . . . . . . .28
  86.      Menus, Submenus. . . . . . . . . . . . . . . . . . . . .29
  87.      Multi-Disk Catalogs. . . . . . . . . . . . . . . . . . .32
  88.      Order Form . . . . . . . . . . . . . . . . . . . . . . .32
  89.      Order Form Template. . . . . . . . . . . . . . . . . . .33
  90.      Pricing. . . . . . . . . . . . . . . . . . . . . . . . .35
  91.      Printer. . . . . . . . . . . . . . . . . . . . . . . . .37
  92.      Print Order Form Menu. . . . . . . . . . . . . . . . . .37
  93.      Program Prompts. . . . . . . . . . . . . . . . . . . . .37
  94.      Program Text . . . . . . . . . . . . . . . . . . . . . .38
  95.      Review Screen. . . . . . . . . . . . . . . . . . . . . .38
  96.      Screen Files . . . . . . . . . . . . . . . . . . . . . .38
  97.      Security . . . . . . . . . . . . . . . . . . . . . . . .39
  98.      Shipping . . . . . . . . . . . . . . . . . . . . . . . .39
  99.      Size Boxes . . . . . . . . . . . . . . . . . . . . . . .40
  100.      Special Forms. . . . . . . . . . . . . . . . . . . . . .42
  101.      Taxes. . . . . . . . . . . . . . . . . . . . . . . . . .42
  102.                                                                
  103. APPENDIX A: Program Limits. . . . . . . . . . . . . . . . . .44
  104. Page ii
  105. ----------------------------------------------------------------------
  106.  
  107. LICENSE AGREEMENT AND WARRANTY
  108.  
  109. License to Use This Software
  110.  
  111. 1.   You may use the program on a single computer at one time. 
  112.      You may not copy the program and accompanying materials
  113.      except for backup purposes.
  114.  
  115. 2.   You may not make copies of the program for sale.
  116.  
  117. 3.   This software is copyrighted, and all rights therein are
  118.      reserved for EmmaSoft.  Registration or purchase of this
  119.      product does not transfer any right, title, or interest in the
  120.      software except as specifically set forth in this agreement. 
  121.      You are hereby notified that the software product is
  122.      protected by United States Copyright Law and International
  123.      Copyright Law, and you may be held by responsible by
  124.      EmmaSoft for any infringement of such rights or violations
  125.      to this agreement.
  126.  
  127. 4.   This license is effective until terminated.  You may
  128.      terminate it at any time by destroying the program and all
  129.      copies of it.  It will also terminate if you fail to comply with
  130.      any term or condition on this agreement.  You agree upon
  131.      termination to destroy the program together with all copies
  132.      of the program.
  133.  
  134. License To Distribute Catalogs
  135.  
  136. 1.   A registered user is an individual or company who has paid
  137.      a registration fee to EmmaSoft and received a registered
  138.      copy of the Catalog-on-A-Disk software with a valid serial
  139.      number from EmmaSoft. 
  140.  
  141. 2.   Only registered users may distribute catalogs using
  142.      CATALOG.EXE.  It is a violation of EmmaSoft's copyright
  143.      for unregistered users to distribute catalogs using the
  144.      program.  Registered users may make unlimited copies of
  145.      CATALOG.EXE and CATALOG.INI to distribute with  their
  146.      catalog. 
  147.  
  148.      Associated individuals or companies not part of the
  149.      registered user must become registered users before
  150.      distributing catalogs with CATALOG-ON-A-DISK.  For
  151.      example, each member of a franchise must individually buy
  152.      a copy of the program.  An easy way to distinguish:  if you or
  153.      your company can receive catalog orders directly from a
  154.      customer you must be a registered user.
  155.  
  156. 3.   If you charge a fee for your catalog it should be explicitly
  157.      understood that you are not selling a copy of the
  158.      CATALOG-ON-A-DISK product, but are simply charging for
  159.      a copy of your catalog.  
  160. Page iiii
  161. ----------------------------------------------------------------------
  162. 4.   CATCOM.EXE, CATCM.EXE and all catalog making
  163.      programs are one license, one computer programs, and must
  164.      not be sent with your catalogs.
  165.  
  166. Warranty
  167.  
  168.      This program is provided "as is" without warranty of any
  169.      kind, either expressed or implied, including any warranty of
  170.      merchantability or fitness for a particular purpose.  In no
  171.      event shall EmmaSoft be held liable for any loss of profit,
  172.      special, incidental, consequential, or other similar claims.
  173.  
  174.  
  175. See the VENDINFO.DIZ file for shareware distribution requirements.
  176.  
  177. Governing law shall be that of New York State.
  178. Page 1
  179. ----------------------------------------------------------------------
  180.  
  181.     CHAPTER ONE: Quick Start Guide
  182.  
  183.     1.1 What is this thing for????!
  184.  
  185.     Catalog-On-A-Disk is a flexible, innovative, cost-effective
  186.     alternative to printed product catalogs.  It's easy for
  187.     customers to order from you using a few simple keys.  They
  188.     can browse or search for items, order as they go along and
  189.     print the order form to printer or file.  The order can then be
  190.     sent my mail, fax, modem, or called in.
  191.  
  192.     You set up your catalog to give it your company's distinctive
  193.     look.  The catalog files are compressed, letting you fit more
  194.     products on a disk, reducing disk access time, and providing
  195.     security for your prices and other data.
  196.  
  197.     Catalog-On-A-Disk is perfect for any product-oriented
  198.     company.  It gives you more flexibility than a printed catalog
  199.     in maintaining updates, and is less expensive to produce.  It
  200.     offers new distribution options, and encourages customers to
  201.     order from you.
  202.  
  203.     1.2 Setting up The Program
  204.     
  205.     Please follow these instructions carefully to get your program
  206.     set up quickly and correctly.
  207.  
  208.     The shareware version of Catalog-On-A-Disk installs from a self-
  209.     extracting ZIP file.  
  210.  
  211.     1.  Create a directory for Catalog-On-A-Disk  MD \CAT4
  212.     2.  Make that the current directory           CD \CAT4
  213.     3.  Call SETUP from the disk it is on:        A:\SETUP -D [ENTER]
  214.  
  215.  
  216.     NOTE!  When you use -D a seperate catalog subdirectory is
  217.     created.  If you want everything in one directory omit -d.
  218.  
  219.     1.3 Tutorial: View The Catalog.
  220.     
  221.     Go to the drive and directory the sample catalog is in (use the 
  222.     DOS CD command), and start the catalog.  Example:  
  223.  
  224.               c:
  225.               cd \cat4\catalog [ENTER]
  226.               catalog [ENTER]
  227.  
  228.     The front cover shows a screen or two introducing your
  229.     company and the catalog itself.  Read the first screen(s) and
  230.     press a key until you see the main menu.
  231.  
  232.     The main menu is like a table of contents.  You use it to
  233.     access the products and information in the body of the
  234.     catalog.
  235. Page 2
  236. ----------------------------------------------------------------------
  237.  
  238.     The whole catalog is menu based.  It uses the [ENTER] key to go
  239.     into a menu choice, and the [Esc] key to back out.  For example,
  240.     put the menu bar over Garden Catalog.  Press  [ENTER] to see a
  241.     listing of products.  
  242.  
  243.     Now place the menu bar over item A10001.  Press  [ENTER] to see
  244.     a description of that product.  
  245.  
  246.     To go back to the product list press e, or press  [ENTER] to order
  247.     this plant.  Type the quantity you want to order.  Press  [ENTER]
  248.     to accept the order.  Now you are back in the product listing. 
  249.     Go ahead and order more products.  When you are finished
  250.     press [Esc] to go back to the main menu.
  251.  
  252.     The catalog remembers each item you order.  You view
  253.     categories of products and order as you go along.  Try some of
  254.     the categories in the sample, and order products.
  255.  
  256.     When you are finished ordering you print the order form.  Go
  257.     to the main menu and press the [Esc] key.  This bring you to the
  258.     Exit menu.  
  259.  
  260.     To print your order pick Print Order Form and follow the
  261.     prompts.  The catalog will ask you to fill in your name and
  262.     address, and may ask for some other information before
  263.     printing the order.  The order form may be printed to the
  264.     printer or to disk so it can be sent by mail, fax, or modem, or
  265.     it may be called in.  The appropriate sales tax and shipping
  266.     charges are calculated in the total.
  267.  
  268.     1.4 Tutorial:  Make A Catalog.
  269.  
  270.     CATCOM helps you create your catalog.
  271.  
  272.     Go to the drive and directory containing the program (use the
  273.     DOS CD command), and start CATCOM.  Example:  
  274.  
  275.  
  276.               c:
  277.               cd \cat4  [ENTER]
  278.               CATCOM  [ENTER]
  279.  
  280.     Pick Files/Make Your Catalog/New File.
  281.  
  282.     Type: WIDGET.TXT
  283.  
  284.     Catcom will ask if you want it to make a sample.  Type: Y
  285.  
  286.     The first two lines contain special information for the category
  287.     file.  
  288.  
  289.     The top line starts with the text that will appear on the main
  290.     menu, followed by a vertical line, a password, and another
  291.     vertical line.  Replace Sample Category with Industrial
  292. Page 3
  293. ----------------------------------------------------------------------
  294.  
  295.     Widgets.  Then blank out the sample password (mypass) so
  296.     there is just a space between the vertical lines.  Now the top
  297.     line should look like this:
  298.  
  299.     Industrial Widgets | |
  300.  
  301.     Line two is the category header.  This is text that appears at
  302.     the top of the product listing screen.  Type:
  303.  
  304.     ~~Num:    Item:                                     Our Low Price:
  305.  
  306.     The first product begins on line three.  Items are listed in
  307.     blocks, and each block can be a product, information block, or
  308.     a coupon.  There is one sample of each type of item.  All
  309.     blocks must begin with a tilde (~).  Product blocks have the
  310.     tilde, an order number, short description and price.
  311.  
  312.     Information blocks begin with a tilde followed by +D+ and
  313.     some descriptive text.  Coupon blocks begin the same way,
  314.     except you use +C+.
  315.  
  316.     You follow the "tilde line" with zero to five hundred lines of
  317.     free form text.  To start the next block simply begin with a
  318.     tilde and repeat the process.
  319.  
  320.     When you are done editing the file press u to save it.  When
  321.     prompted with Compression Options? press Y.  Now you are
  322.     prompted to choose a palette.  Press 5  [ENTER].  From the menu
  323.     list pick Main Menus.  Now pick CATALOG.TL.  When asked
  324.     if you want to Compress Now? press Y.  After the file has
  325.     been compressed you are returned to the menu.
  326.  
  327.     Pick Files/View Catalog.  Industrial Widgets has been added
  328.     to the main menu.  You can choose it to view and order the
  329.     products you just added.
  330. Page 4
  331. ----------------------------------------------------------------------
  332.  
  333.     CHAPTER TWO: All About Catalogs
  334.  
  335.     2.1 Who uses Catalog-On-A-Disk?
  336.  
  337.     Catalog-On-A-Disk is used by many kinds of companies all
  338.     over the world.  These include computer hardware and
  339.     software companies, book sellers and publishers, office
  340.     suppliers, parts suppliers (including motorcycle parts,
  341.     hardware, funeral supplies, industrial parts), specialty
  342.     companies (including an antique maps company), travel
  343.     companies and many others.
  344.  
  345.     Catalogs come from the United States, Canada, England,
  346.     Australia, France, Austria, New Zealand, Scotland, West
  347.     Indies, Brazil, Fiji Islands, The Netherlands, Switzerland, and
  348.     many other places.
  349.  
  350.     Most of these companies distribute their catalogs on floppy
  351.     disks, while others are taking advantage of other methods
  352.     including removable storage devices, hard drives, and modem
  353.     transfer.  One manufacturer of notebook computers puts a
  354.     Catalog-On-A- Disk catalog on the hard drive of each
  355.     computer they sell so their customers can easily order a new
  356.     peripheral or an additional machine.
  357.  
  358.     Sales people keep their Catalog-On-A-Disk catalog on their
  359.     notebook computer so they can take orders as they travel from
  360.     site to site.  They print the orders to their hard disks and
  361.     upload them to their home offices at night when the phone
  362.     rates are lower.
  363.  
  364.     Companies post copies of their catalog on BBSs so customers
  365.     can download them.  A company in England has set up a
  366.     catalog to automatically call the store and print the order
  367.     form on a printer so a clerk can fill the order immediately.
  368.  
  369.     Consultants have lucrative businesses using Catalog-On-A-
  370.     Disk to build catalogs for clients. 
  371.  
  372.     You'll find many  creative ways to distribute your catalog
  373.     using Catalog-On-A-Disk.
  374.  
  375.     2.2 What Makes Up a Catalog
  376.  
  377.     The original versions of catalog files are ASCII text files.  Use
  378.     Catcom to compress these files into a form the reader can
  379.     understand.
  380.  
  381.     The catalog you send out includes the catalog reader 
  382.     (CATALOG.EXE), menu files (text files ending with .TL or
  383.     .FM), and the compressed versions of the catalog files (with
  384.     the extension .CM).
  385. Page 5
  386. ----------------------------------------------------------------------
  387.  
  388.     CHAPTER THREE: Parts of a Catalog
  389.  
  390.     Most catalogs have three main parts.  
  391.  
  392.     The cover makes the first impression.  It often has a company
  393.     logo, a splash of enticing information, and details about what
  394.     you will find inside.
  395.  
  396.     The body of the catalog contains the product listings, prices,
  397.     helpful information, hints, and so on.
  398.  
  399.     The insert contains an order form, ordering information, and
  400.     coupons.
  401.  
  402.     Your Catalog-On-A-Disk catalog also has these sections, and
  403.     gives you a great deal of flexibility in creating each one.  The
  404.     body is required.  The insert is also required.  You need it to
  405.     print the order form.  However, the Special Forms menu is
  406.     optional, and if you decide not to use it the menu
  407.     automatically adjusts to remove the option.  The cover is
  408.     completely optional.
  409.  
  410.     3.1 The Cover
  411.  
  412.     The cover of your catalog can be text screens, an outside
  413.     program such as a graphics logo viewer, or both.
  414.     
  415.     3.2 The Body
  416.     
  417.     The body of your catalog is controlled by (and includes) the
  418.     main menu screen.  Menu choices are kept in small
  419.     uncompressed files with the .TL extension.  (You can see
  420.     examples of these in the sample catalog's CATALOG.TL file. 
  421.  
  422.     Customers can access the cover and the insert as well as
  423.     Category files, Command files, Catalog commands, Screen files,
  424.     and Submenus.
  425.  
  426.     3.3 The Insert
  427.  
  428.     At the main menu you can press the [Esc] key to reach the
  429.     insert, or Exit menu.  This is a small menu that lets the
  430.     customer print an order form, review the current order, enter
  431.     a shipping address, and (optionally) show the special forms
  432.     menu.
  433.  
  434.     The special forms menu has most of the same capabilities of
  435.     the main menu, the difference being that its menu files use
  436.     the .FM extension instead of .TL.
  437.  
  438. Page 6
  439. ----------------------------------------------------------------------
  440.     3.4 Other Features
  441.  
  442.     CATALOG.EXE was designed around two keys:  [ENTER] and e. 
  443.     Enter brings you in to the next level of the program, and
  444.     Escape backs you out.  If you are at the main menu [Esc] takes
  445.     you to the exit menu and vice versa.
  446.  
  447.     The menu takes up part of the screen - the rest is used by a
  448.     header screen you can use for company information and to
  449.     display important key-press information.
  450.  
  451.     An information screen is available from anywhere in the
  452.     catalog by pressing a I or i.  This is used to place your
  453.     company information, address, phone number - any
  454.     information that summarizes the catalog and your company.
  455.     The main purpose of the Exit menu is to print the order form. 
  456.     It also lets you review your order and delete items you don't
  457.     really want, and to enter your name and the address you
  458.     want the order shipped to.  You can always go back to the
  459.     body of the catalog to order more products.
  460.  
  461.     An optional feature of the Exit menu is the Special Forms
  462.     menu.  This has the same features as the main menu, though
  463.     it is usually used to hold coupons and informational files (like
  464.     The History of Consolidated Widgets, or Our Return Policy).
  465. Page 7
  466. ----------------------------------------------------------------------
  467.  
  468.     CHAPTER FOUR: Catalog Features
  469.  
  470.     Catalog-On-A-Disk has many powerful features to help you
  471.     sell. You probably will not use all of them in a single catalog. 
  472.     When you set up your catalog you configure the features to
  473.     best work for your company.  If you do not want the customer
  474.     to know about certain features - simply do not document them
  475.     in your screens.
  476.  
  477.     4.1 Keys In The Catalog
  478.  
  479.     Here is a complete listing of keys in the catalog and what
  480.     they do:
  481.  
  482.     [Alt] [H]       [Alt] [F1]       Display a Help Bar
  483.     [Alt] [I]       [F4]             Program Information
  484.     [Alt] [S]       [F2]             Search
  485.     [Alt] [N]       [Alt] [F2]       Next search instance
  486.     [Alt] [X]       [F10]            Exit the program
  487.     [F1]                             Context sensitive help
  488.     [ENTER]                          Go in to the next level (category,
  489.                                      product, order, etc.
  490.     [Esc]                            Back out of current window or
  491.                                      toggle between main and exit
  492.                                      menus
  493.     [PgUp]                           More Categories or Products
  494.     [PgDn]                           More Categories or Products
  495.     
  496.     If you are at the Main Menu press [Esc] to get to the Exit Menu. 
  497.     Press [Esc] again to return to the Main Menu.
  498.  
  499.     When viewing the category menu or categories that are larger
  500.     than one screen the arrow keys work as follows:
  501.  
  502.  
  503.  
  504.     [Up]      Up one choice.  Scrolls to next screen full.  Stops
  505.               at first choice.
  506.     [Dn]      Down one choice.  Scrolls to next screen full. 
  507.               Stops at last choice with a message.
  508.  
  509.     [Lt]      Same as up arrow, but wraps to the bottom of
  510.               the window instead of scrolling.
  511.     [Rt]      Same as down arrow, but wraps to the top of
  512.               the window instead of scrolling.
  513.  
  514.  
  515.     If you are using a mouse the left button acts like the  [ENTER]
  516.     key, and the right button like the [Esc] key.  If little arrows are
  517.     at the bottom of your screen, clicking on the up arrow works
  518.     like pressing [PgUp] and clicking on the down arrow like PgDn.  Clicking
  519.     at the top of the screen is like pressing [Up], and at the bottom
  520.     like pressing [Dn].
  521. Page 8
  522. ----------------------------------------------------------------------
  523.  
  524.     4.2 Menus and Products
  525.  
  526.     The [ENTER] key takes you to each level and makes it easy to
  527.     order.  At the main menu use the arrow keys to place the
  528.     menu bar on a category you want.  Press  [ENTER].
  529.     
  530.     Now you see a list of products.  Place the menu bar on the
  531.     one you are interested in and press  [ENTER].
  532.     
  533.     Read the product description.  To order that product press 
  534.     [ENTER].  
  535.  
  536.     Ordering is that simple.  At any level you can press [Esc] to go
  537.     back.  This makes it extremely easy for customers to navigate
  538.     the catalog.
  539.  
  540.     4.3 Products, Information, Coupons
  541.  
  542.     Category files contain products, information blocks and/or
  543.     coupons.  These can be mixed and matched in any category
  544.     file.  They work similarly, but each has special features.
  545.  
  546.     Products may be ordered as well as viewed.  Size Boxes may
  547.     be added to products so the customer chooses the product in a
  548.     special size, color, or type (for example, in a clothing catalog).
  549.  
  550.     Information is just that:  it is viewed, but can not be ordered.
  551.     
  552.     Coupons are like information blocks, except the customer can
  553.     print them while viewing them.
  554.  
  555.     4.4 Search
  556.  
  557.     The search function lets you find any text in a category file
  558.     including the long and short descriptions, order number and
  559.     price. 
  560.  
  561.     Use [Alt] [S] or [F2] to search for any text while viewing a
  562.     category menu, or from the main menu.  A window pops up
  563.     asking for the text to search for.  After typing it in, press 
  564.     [Enter] to search from the current location.  If text is found you
  565.     may view the long description, and if found in a Product
  566.     Block you may order the product.  The search string will be
  567.     highlighted on the screen.  Press [Alt] [N] or [Alt] [F2] to 
  568.     search for the next instance of the text.
  569.  
  570.     When creating your catalog it may help to use key words to
  571.     identify groups of products.  This gives customers a way of
  572.     finding products of interest.
  573.  
  574.     If the search string is not found in the current category all
  575.     following categories on the current menu will be searched.
  576. Page 9
  577. ----------------------------------------------------------------------
  578.  
  579.     4.5 Order
  580.  
  581.     When you are finished choosing the products you want you
  582.     print the order form.  CATALOG.EXE can print it to a printer
  583.     or disk file.  This is as simple as choosing Print Order Form
  584.     from the exit menu and following the prompts.
  585.  
  586.     Ordering can have many features attached to it.  Your catalog
  587.     can be set up to automatically charge sales tax when
  588.     appropriate, and to add shipping and handling charges.  
  589.     
  590.     You can add a questionnaire that asks special questions
  591.     before the form is printed.  This can be used to get credit card
  592.     numbers and other important information.  The answers are
  593.     printed on the order form.
  594.  
  595.     4.6 Print
  596.  
  597.     You can print the whole catalog on your printer, or you can
  598.     print individual categories.  Make sure your printer is ready
  599.     (and has plenty of paper).  This takes some time, so you
  600.     should be sure you want to do it before starting.  Catalogs can
  601.     only be printed on printers attached to LPT1.
  602.  
  603.     To print one category go to the main menu, place the menu
  604.     bar on the category you want to print and press [Alt] [P].
  605.     
  606.     To print the whole catalog go to the Exit menu and press [Alt] 
  607.     [P].  Printing the entire catalog may also be a choice on the
  608.     main menu.
  609.  
  610.     4.7 Help
  611.  
  612.     Two kinds of help are available:  a help bar can be toggled in
  613.     and out of view by pressing [Alt] [H].  The [F1] key brings up
  614.     context-sensitive help that you may create to suit you own
  615.     catalog.
  616. Page 10
  617. ----------------------------------------------------------------------
  618.  
  619.     CHAPTER FIVE: Catcom: Making A Catalog
  620.  
  621.     5.1 The Basics
  622.  
  623.     A catalog is made up of the catalog reader (CATALOG.EXE),
  624.     the initialization file (CATALOG.INI), the internal text file
  625.     (CATALOG.CM) menu files, and catalog files.
  626.  
  627.     Menu files are ASCII text files that contain the text that
  628.     appears on menus, and tells the reader how to access the files
  629.     or perform the functions.  Minimally you must have one menu
  630.     file called CATALOG.TL.  This contains the first level of the
  631.     main menu.  Other main menu files must have the .TL
  632.     extension.  Similarly, the first Special Forms menu is called
  633.     CATALOG.FM, with submenus sharing the .FM extension.
  634.     
  635.     Catalog files start out as ASCII text files.  You use Catcom to
  636.     compress them, and the compressed version goes out with
  637.     your catalog.  The steps in building a catalog are:
  638.  
  639.            1.   Create the text versions of your catalog files.
  640.     
  641.            2.   Compress the catalog files.
  642.     
  643.            3.   Copy CATALOG.EXE, CATALOG.INI, .TL and
  644.                .FM files and your compressed (.CM) files to a
  645.                disk.
  646.  
  647.     There are three kinds of catalog file.  Each is identified by a
  648.     unique file name extension.  
  649.  
  650.     Category Files:          Files that contain products.  They can
  651.                              also contain descriptions and/or coupons. 
  652.                              These files end with the .TXT extension. 
  653.                              Example: HARDWARE.TXT
  654.  
  655.  
  656.     Screen Files:            Display files that appear on the screen
  657.                              but do not contain product, description,
  658.                              or coupon blocks.  They have the .CAT
  659.                              extension.  Example:  FIRST.CAT
  660.  
  661.     Configuration Files:     Any file that does not appear on the
  662.                              screen that is used to configure your
  663.                              catalog in some way.  These files always
  664.                              end with the .CTF extension.  Example: 
  665.                              TOTAL.CTF
  666.  
  667.     After they are compressed all catalog files share the extension
  668.     .CM.  Examples:  HARDWARE.CM, FIRST.CM, TOTAL.CM
  669. Page 11
  670. ----------------------------------------------------------------------
  671.  
  672.     5.2 Using Catcom
  673.  
  674.     You make your catalog with CATCOM.  Start the program
  675.     (replace the example drive and directory with your real one if
  676.     it is different):
  677.  
  678.                            C:  [ENTER]
  679.                            CD\CAT4  [ENTER]
  680.                            CATCOM [ENTER]
  681.  
  682.     There are three pull-down menus on the menu bar at the top
  683.     of the screen:
  684.  
  685.     Files          Create your catalog files and manipulate them. 
  686.                    Use this menu to compress the files (so they can
  687.                    be read by the catalog program), delete them,
  688.                    copy your catalog, and view it.
  689.  
  690.     Setup          This menu sets your catalog colors and program
  691.                    settings (such as tax and address settings, help
  692.                    bar and mouse).
  693.  
  694.  
  695.     Options        This menu sets CATCOM's colors, look and
  696.                    behavior.  You also set the path to your catalog
  697.                    so CATCOM knows where on your system to
  698.                    find it.
  699.  
  700.     To create or edit a catalog file choose File/Make Your
  701.     Catalog.  You are presented with a list of files that are
  702.     typically included in a catalog.  While all the files on the list
  703.     are not required, this list makes it easy to keep your catalog
  704.     files up to date.
  705.  
  706.     Pick a file from the menu.  If that file does not exist Catcom
  707.     may be able to create a sample for you.  This sample can be
  708.     quite helpful as a template to edit your own catalog
  709.     information in.  The sample file (or the old version of the file,
  710.     or a new blank version) is automatically loaded into the text
  711.     editor.
  712.  
  713.     When you are done editing you are prompted for compression
  714.     options.  You should choose Yes if this is a new file, or if you
  715.     want to compress the file right away.  This insures the file is
  716.     included in the compression list, which is a list of all the files
  717.     that make up your catalog.
  718.  
  719.     The internal Catcom Editor uses these keys:
  720.     
  721.     [F10]            Save and exit
  722.     [Esc]            Exit without saving
  723.     [Alt] [S]        Save
  724.     [Alt] [I]        Import a file into the current file
  725.     [Alt] [C]        Insert a color code
  726.     [Alt] [C]        Insert a macro code
  727. Page 12
  728. ----------------------------------------------------------------------
  729.  
  730.     [F2]             Search for text
  731.     [F3]             Find next
  732.     [F4]             Begin Block
  733.     [F5]             End Block
  734.     
  735.     [Ctl] [Y]        Delete a line
  736.     [Ctl] [Del]      Delete a block
  737.     [F6]             Mark word
  738.     [Alt] [F6]       Mark to beginning of line
  739.     [Ctl] [F6]       Mark to end of line
  740.     [F7]             Copy block
  741.     [F8]             Move Block
  742.  
  743.     [Ctl] [Rgt]      Right one word
  744.     [Ctl] [Lft]      Left one word
  745.     [Ctl] [Up]       Up one word
  746.     [Ctl] [Dn]       Down one word
  747.     [Ctl] [U]        Top of file
  748.     [Ctl] [d]        Bottom of file 
  749.     [Ctl] [h]        Top of screen
  750.     [Ctl] [E]        Bottom of screen
  751.     [Home]           Beginning of line
  752.     [End]            End of line
  753.     [PgUp]           Up one screen
  754.     [PgDn]           Down one screen
  755.  
  756.     5.3 Compressing
  757.  
  758.     Catalog files do not show up in your catalog until they are
  759.     compressed.  All compressed files have the same name as the
  760.     original, but the extension is changed to .CM.  The
  761.     compressed version of HAMMERS.TXT, for example, will be
  762.     called HAMMERS.CM.  Only the compressed (.CM) version is
  763.     used by the catalog reader.
  764.  
  765.     When a catalog file is compressed special codes are added to it
  766.     that tell the catalog reader how to handle the file.  The file is
  767.     also added to a menu at this stage.
  768.  
  769.     When you choose compression options you are given the
  770.     choice to compress the file right away, or simply to add the
  771.     file to the catalog compression list.  Whether or not you
  772.     compress the file now it will be added to the list for future
  773.     use.
  774.  
  775.     You can save time by not compressing the files one at a time. 
  776.     Once they are on the list you can choose Files/Whole Catalog
  777.     to compress every file listed.  (To check which files are on the
  778.     list view compress.crf.  Do not try to edit this file!)  
  779. Page 13
  780. ----------------------------------------------------------------------
  781.  
  782.     Choose Files/Compress to compress a single file, even if it is
  783.     on the list.  Catcom always checks the list to see if you have
  784.     already set options for that file.  If so you may use the old
  785.     settings or choose new ones.  
  786.     
  787.     5.4 Managing Your Catalog
  788.     
  789.     Catcom uses two catalog response files to keep lists of what
  790.     belongs in your catalog.  
  791.     
  792.     The first, CATALOG.CRF, is a list of non-compressed files
  793.     such as CATALOG.EXE, CATALOG.INI, menu files, command
  794.     files and the programs and files needed by them, and so on. 
  795.     NOTE! Before copying your catalog you should check the 
  796.     CATALOG.CRF file to make sure it contains everything it
  797.     should.
  798.  
  799.     The second list, COMPRESS.CRF, is created when you
  800.     compress your catalog files.  It is a compression script that
  801.     CATCOM uses when you compress choosing Files/Whole
  802.     Catalog.  NOTE! You should not edit this file directly - let
  803.     CATCOM maintain it.
  804.  
  805.     Together the two .CRF files comprise a master list of every
  806.     file in your catalog.
  807.  
  808.     Use File/Make Your Catalog to add categories and other files
  809.     to the catalog.  
  810.  
  811.     Use File/Delete A Category to delete category files from your
  812.     catalog.  Pick the compressed (.CM) file you want removed,
  813.     and confirm that you want to delete it.  This removes the file
  814.     from the compression list, and erases the compressed file (the
  815.     text version is not deleted, so you may re-instate it later just
  816.     by compressing the text file again.  Finally, the choice is
  817.     removed from the menu.
  818.  
  819.     5.5 Catalog Settings
  820.     
  821.     Catalog files contain the content of your catalog.  Catalog
  822.     settings control its behavior.  CATCOM records these settings
  823.     in CATALOG.INI. 
  824.  
  825.     5.51 Colors
  826.  
  827.     Pick Setup/Colors to set the colors for your catalog.  Three
  828.     sample views of the catalog reader are shown on the screen,
  829.     and these show you how your catalog will appear as you
  830.     change colors.
  831.  
  832.     The catalog can use up to six color palettes.  When you
  833.     compress a catalog file you pick one of these palettes to be
  834.     used for that file.  Palette 1 is the only one required, but you
  835.     will probably want to use at least a few palettes to give types
  836.     of files a distinctive look.  For example, you could use Palette
  837. Page 14
  838. ----------------------------------------------------------------------
  839.  
  840.     2 for help files.  In addition you set the colors the brand
  841.     message and help bar will appear in.
  842.     
  843.     As you move the menu bar the sample views show the color
  844.     combination for that palette.  Press [ENTER] to set palette colors:
  845.     
  846.     Main Color:         Main window text
  847.     Highlight Color:    Used when you use the ` symbol without
  848.                         a four character color or macro code in a
  849.                         catalog file.    This is for compatibility
  850.                         with version 3 catalog files.
  851.     Menu Color:         Main Menu Color
  852.     Menu Bar:           Highlights a choice on a menu
  853.     Message Box:        Message text.
  854.     
  855.     Warnings:           Warning text (usually appears at the
  856.                         bottom of a menu window).
  857.  
  858.     Press [Esc] to get back to the Palettes menu, and press [Esc] again
  859.     to return to the main menu.
  860.  
  861.  
  862.  
  863.     5.52 Settings
  864.  
  865.     Choose Setup/Settings to see the Catalog Setup Screen.  
  866.  
  867.     Nationality:
  868.  
  869.     US:                 Uses US conventions 
  870.     International:      Uses international conventions
  871.  
  872.  
  873.     Address Lines:
  874.  
  875.     Customers type their address in the catalog so it will print on
  876.     the order form.  You can specify up to twelve address fields
  877.     (such as name, street, city, and so on).  Headings for these
  878.     lines are in CATALOG.CTF, lines 169-180.
  879.  
  880.  
  881.  
  882.  
  883.     City Line:
  884.  
  885.     The city line is the address line you want the customer to
  886.     type his city in.  When printing the address on the order form
  887.     this forces the next two fields to print on the same line.  
  888.  
  889.     1. Name
  890.     2. Street
  891.     3. City
  892.     4. State
  893.     5. Zip Code
  894.     6. Phone
  895. Page 15
  896. ----------------------------------------------------------------------
  897.     
  898.     In the above list of address fields, if you choose 3 as your city
  899.     line the address will print as follows:
  900.  
  901.     Name
  902.     Street
  903.     City, State, Zip
  904.     Phone
  905.  
  906.     Tax Match:
  907.  
  908.     If the catalog is set to charge sales tax in one state or
  909.     province it will attempt to match the text in one address field
  910.     (example: "NY" in the state field) with text stored in the file
  911.     containing your tax setup (total.ctf).  You must tell the catalog
  912.     which address field to attempt the match on.  In the above
  913.     example you would choose 4 to match on the state field.
  914.  
  915.     Who To Tax:
  916.  
  917.     Choose All if you must apply a sales tax across the board to
  918.     all of your customers.  Choose Selected if you collect taxes
  919.     from selected customers only.  Choose Selected if you are not
  920.     required to charge a tax.  (See the section on Taxes in the
  921.     next chapter.)
  922.  
  923.     What to Tax:
  924.  
  925.     This setting lets you determine whether taxes will be charged
  926.     for merchandise only, or both merchandise and shipping
  927.     charges.
  928.  
  929.     Currency Character:
  930.  
  931.     Set the currency character for your country's money.
  932.  
  933.     Date Setup:
  934.  
  935.     This setting allows you to choose from a variety of date
  936.     formats.
  937.  
  938.     Name Box:
  939.  
  940.     The name box is a window in which your customer types
  941.     name, shipping address, phone numbers, and so on to be
  942.     printed on the order form.
  943.  
  944.     Before the order form is printed the Name Box pops up so the
  945.     customer can fill in his name and address to be printed on the
  946.     order form.  The first setting determines whether it pops up
  947.     each time the customer orders, or only if the box hasn't been
  948.     filled in yet.
  949. Page 16
  950. ----------------------------------------------------------------------
  951.  
  952.     You can also have the name box pop up after the First file
  953.     has been displayed, before the main menu.  The second
  954.     setting enables or disables this feature.
  955.  
  956.     Printing:
  957.  
  958.     This setting only affects the printout of category files.  
  959.  
  960.     Save Session:
  961.  
  962.     If a customer exits the program before printing the order form
  963.     the current ordering session could be lost.  If you set your
  964.     catalog to Save Unfinished Orders the customer will be asked
  965.     whether the current session should be saved.  If so, all the
  966.     products ordered so far will be included in the next session,
  967.     and the customer will be reminded of this.
  968.  
  969.     Product Sort:
  970.  
  971.     This setting allows the catalog to sort products by order
  972.     number.  The sort is applied only to products ordered in the
  973.     current session.
  974.  
  975.     Mouse:
  976.  
  977.     Enable means customers will be able to use their mouse if
  978.     they have one.  Disable means the mouse will not be used in
  979.     your catalog even if the customer has one.
  980.  
  981.     Box Type:
  982.  
  983.     This setting determines whether your catalog will use single
  984.     or double lines in window borders.
  985.  
  986.     Help Bar Default:
  987.  
  988.     Pressing a H toggles the help bar at the bottom of the
  989.     screen.  Setting this to On means the help bar will appear
  990.     when the catalog is first started.  Off means it will not
  991.     appear, but can be made to display using a H.
  992.  
  993.     Help Bar Text
  994.  
  995.     Enter the text you want to appear in the Help Bar at the
  996.     bottom of the screen.
  997.  
  998.     5.6 Catcom Options
  999.  
  1000.     In the Options menu you determine the behavior of Catcom.
  1001.     Colors, Frames, and  Sound determine how Catcom appears
  1002.     on the screen, and turns warning beeps on or off.
  1003.  
  1004.     The most important section here is Options/Path.  
  1005. Page 17
  1006. ----------------------------------------------------------------------
  1007.  
  1008.     Catalog Path tells Catcom where to look for your catalog files. 
  1009.     Type in the full path, with no trailing backslash.  Example: 
  1010.     C:\CAT4\CATALOG
  1011.  
  1012.     Editor Path lets you attach your favorite text editor to Catcom
  1013.     for creating and editing your catalog files.  To use the internal
  1014.     editor type INTERNAL in this field.
  1015.  
  1016.     Viewer Path lets you attach your favorite viewer to Catcom for
  1017.     viewing compression and copy logs.  To use the internal
  1018.     viewer type INTERNAL in this field.
  1019.  
  1020.     5.7 Copying Your catalog
  1021.  
  1022.     To copy your finished or in-progress catalog to a disk or to
  1023.     another directory on your hard disk choose Files/Copy
  1024.     Catalog.  When prompted type the disk (and directory) you
  1025.     want to copy to.  Do not type a trailing back slash.
  1026.  
  1027.     Examples:      A:
  1028.                    C:\FINISHED
  1029.  
  1030.     After your catalog is copied you are prompted to view a log.  It
  1031.     will tell you which files were successfully copied, and note any
  1032.     that were not.
  1033.  
  1034.     NOTE:  Before copying your catalog double check CATALOG.CRF
  1035.     to make sure the list is complete.  (See Managing Your
  1036.     Catalog, above, for more information.)
  1037. Page 18
  1038. ----------------------------------------------------------------------
  1039.  
  1040.     CHAPTER SIX: Features Reference
  1041.  
  1042.     Address Setup (Name Box)
  1043.  
  1044.     Customers type their name, address, and other information
  1045.     you ask for in the Name Box.  This information is printed on
  1046.     the order form, and can be accessed by using macros in your
  1047.     catalog files.
  1048.  
  1049.     You use Catcom (Setup/Settings) to define the Name Box.   It
  1050.     can use up to 12 fields for address, phone number and other
  1051.     information you want.  Use Catcom to set up your address
  1052.     lines.  Adjust the headings for each line (a "heading" is the
  1053.     text that appears in the "Name" window before the field, such
  1054.     as "Name:"  or "Street1:") starting on line 165 in
  1055.     CATALOG.CTF.  Line 165  is field 1, 166 is field 2, and so
  1056.     on..
  1057.  
  1058.     You must set these items to define your Name Box:
  1059.  
  1060.     1.   Number of address fields wanted (1-12).
  1061.  
  1062.     2.   The number of the "City" line.  This is needed so
  1063.          Catalog knows how to print the address.  It assumes
  1064.          that the field immediately following the "City" line is
  1065.          the "State" line, and the line following that is the "ZIP"
  1066.          line.  When printing each field appears on its own line
  1067.          except these three, which are printed as follows:  CITY,
  1068.          STATE ZIP
  1069.  
  1070.     3.   Tax Match field.  This tells Catalog which of the 12
  1071.          fields (or however many you have set up) to match for
  1072.          sales tax (the matching information is  contained in
  1073.          total.ctf).
  1074.  
  1075.     You also use Catcom to set when and where the Name Box
  1076.     appears.  It is always accessible on the Exit Menu.  It also
  1077.     appears when printing the order form, and it can appear right
  1078.     after the First Screen, before the main menu.  You decide
  1079.     whether you want it to appear every time an order is printed,
  1080.     or only if it has not been filled in.
  1081.  
  1082.  
  1083.     Asking Extra Order Form Questions
  1084.  
  1085.     When printing the order form you can add your own
  1086.     questions for the customer to answer before the form is
  1087.     printed.  The answers are printed on the order form.  This
  1088.     feature is useful for determining method of payment, credit
  1089.     card number and expiration date, and so on.  There is no
  1090.     limit to the number of questions you may ask.
  1091. Page 19
  1092. ----------------------------------------------------------------------
  1093.  
  1094.     Create a file called EXTRA.CTF.  Each line in this file is for
  1095.     one question/answer, and is divided into four parts:
  1096.  
  1097.     1.   The question to ask.
  1098.     2.   A heading to print on the order form before printing
  1099.          the answer.
  1100.     3.   The maximum number of characters for the answer (do
  1101.          not use more than 76 including the heading and
  1102.          answer)
  1103.     4.   The number of characters from the left margin the
  1104.          answer should be indented on the order form.
  1105.  
  1106.     Example:
  1107.  
  1108.     Pay By Check, MC, Visa, Amex? | Payment Method: | 8 | 0
  1109.  
  1110.     If the customer answers "Visa" the answer will appear on the
  1111.     order form this way:
  1112.  
  1113.     Payment Method:  Visa
  1114.  
  1115.     After compressing the file the questions will appear when
  1116.     printing the order form.
  1117.  
  1118.  
  1119.     Category Files (Products, Descriptions, Coupons)
  1120.  
  1121.     Category Files (.TXT) are the heart of your catalog.  They
  1122.     contain the products you are selling.  They can also contain
  1123.     much more.  Each item in a category is entered in a block of
  1124.     data.  You use Product Blocks to list products that customers
  1125.     can order.  Information Blocks hold information for customers
  1126.     to read.  Coupon Blocks can be read on the screen, or printed
  1127.     on a printer.  The three types of block can be mixed and
  1128.     matched in any category file.
  1129.  
  1130.     When you choose a product from a category menu the long
  1131.     description is displayed.  Press the [ENTER] key to order that
  1132.     product.  In Information and Coupon blocks pressing [ENTER] at
  1133.     this point brings you back to the category menu.
  1134.  
  1135.     Each category file begins with two lines that set up the file. 
  1136.     They are followed by the blocks you want to appear in that
  1137.     category.
  1138. Page 20
  1139. ----------------------------------------------------------------------
  1140.  
  1141.     The first line begins with the text you want on the menu for
  1142.     that category.  This is followed by two vertical lines.  If you
  1143.     want to protect the file against unauthorized decompression
  1144.     you may enter a short password between the two vertical
  1145.     lines - otherwise just leave a space between them.
  1146.  
  1147.     Example:
  1148.  
  1149.     Wrenches | |
  1150.  
  1151.     The second line is the Category Header.  This is one line of
  1152.     text that will appear at the top of the category menu in the
  1153.     catalog.  This line always begins with two tildes (~~), 
  1154.     followed by your text.
  1155.  
  1156.     Example:
  1157.  
  1158.     ~~No.      Item Description:                     Our Low Price
  1159.  
  1160.  
  1161.     Blocks must be a minimum of one line in the file.  Each block
  1162.     begins with a single tilde (~).  If you want a long description
  1163.     for an item you may add up to 500 lines of free-form text after
  1164.     the first line.  To start another block you simply begin it with
  1165.     a tilde.
  1166.  
  1167.     Product Blocks begin with a tilde (~) followed by an order
  1168.     number, short description and price.  If you want to attach a
  1169.     freight charge to a product you follow the price with two
  1170.     vertical lines and the freight charge.
  1171.  
  1172.     NOTE!   Never use a currency character when entering prices.  Use
  1173.     numbers and a decimal point only!
  1174.  
  1175.     Example:
  1176.  
  1177.     ~A10005-FL   Steel Crow Bar                         15.95 |  | 4.50
  1178.     Long description text starts here.
  1179.  
  1180.     If you do not use order numbers leave a space after the tilde
  1181.     before beginning the short description.  A short description
  1182.     and price are required.  Size Boxes (see below) may be part of
  1183.     the long description in Product Blocks, and must be part of
  1184.     the 500 line maximum allowed.
  1185.  
  1186.     If you have attached a freight charge you should mention it
  1187.     toward the top of the long description.
  1188.  
  1189.     Description Blocks also begin with a tilde, followed by "+D+"
  1190.     and the short description text.  Follow this with from 0 to 500
  1191.     lines of text.  Example:
  1192.  
  1193.     ~+D+How You Can Order From Us
  1194.     Long description text starts here.
  1195. Page 21
  1196. ----------------------------------------------------------------------
  1197.  
  1198.     Coupon Blocks  start with a tilde,  "+C+",  and the short
  1199.     description text.  Follow this with from 0 to 500 lines of text.
  1200.     Example:
  1201.  
  1202.     ~+C+Free Gift With This Coupon
  1203.  
  1204.     Long description text starts here.
  1205.  
  1206.  
  1207.     CD-ROM Catalogs
  1208.  
  1209.     If you are distributing your catalog on CD-ROM or other
  1210.     read-only media you must move certain files to a writable
  1211.     medium such as a hard disk drive or floppy disk.  This is
  1212.     because the catalog must write certain files from time to time.
  1213.  
  1214.     The following files must be placed on writable medium: 
  1215.  
  1216.          CATALOG.EXE (Required)
  1217.          CATALOG.INI  (Required)
  1218.          STRDORD (Optional)
  1219.          CATSEND.EXE  (If you are using the Catsend Utility)
  1220.          CATSEND.SC   (If you are using the Catsend Utility)
  1221.          Any other programs and their files that require disk
  1222.          writing.
  1223.  
  1224.     In addition you must include a file called CATLOC.COD that
  1225.     contains the path to the catalog files.  This should include a
  1226.     drive letter followed by a colon and a backslash, with the
  1227.     path, if any.  Do not include a file name or trailing backslash.
  1228.  
  1229.     Examples:      g:\catalog
  1230.  
  1231.     The SETCAT utility can be used to automatically copy the
  1232.     files and create the CATLOC.COD file.
  1233.  
  1234.     NOTE!   WARNING!  Before mastering your catalog on CD, test,
  1235.     test, test!!!  Make sure everything is working before you go to
  1236.     the expense of manufacturing your CD.  A mistake at this
  1237.     point can't just be re-copied as it can be on floppy disk.
  1238.  
  1239.  
  1240.     Colors and Macros
  1241.  
  1242.     Colors and macros give you enormous control over the look of
  1243.     your catalog.  This is done by using a four-character code in
  1244.     the text files.  When CATALOG.EXE finds such a code it
  1245.     replaces it with a value it represents.  This can result in
  1246.     subsequent text being printed in a new color, or in some data
  1247.     (such as today's date) being inserted.
  1248. Page 22
  1249. ----------------------------------------------------------------------
  1250.  
  1251.     The CATCOM internal editor can automatically insert color
  1252.     and macro codes using simple functions.  Use a C for colors,
  1253.     and s C for macros.  The color function lets you choose the
  1254.     color to insert from a color chart.  The macro function lets you
  1255.     pick from a list of available macros.
  1256.  
  1257.     Colors:
  1258.  
  1259.     In addition to the palette colors you set with Catcom you can
  1260.     use any color combination in your category, form, and screen
  1261.     files by using color codes.  Color codes are made up of four
  1262.     characters:
  1263.  
  1264.       1.  The color symbol  `
  1265.       2.  Dark or Light     DL
  1266.       3.  Foreground Color  KBGCRMYW
  1267.       4.  Background Color  KBGCRMYW
  1268.  
  1269.     These letters mean the following:
  1270.  
  1271.     D  Dark        L  Light
  1272.     K  Black       R  Red
  1273.     B  Blue        M  Magenta
  1274.     G  Green       Y  Yellow
  1275.     C  Cyan        W  White
  1276.  
  1277.  
  1278.     Foreground colors can be either dark or light.  Background
  1279.     colors are dark only.  So `DWB means Dark (normal) White
  1280.     on a Blue background.  `LYK means Light Yellow on Black.
  1281.  
  1282.     These codes are case-sensitive.  They MUST be upper case
  1283.     letters.
  1284.  
  1285.     There are two other color symbols:
  1286.  
  1287.     `DPK Returns to the Normal Color from the current palette
  1288.     `DHK Returns to the Bold color from the current palette
  1289.  
  1290.     To make the word "line" appear as light Cyan on a Blue
  1291.     background, and the rest of the line in the "Normal" palette
  1292.     color, type it this way:
  1293.  
  1294.       This is a `LCBline`DPK of colored text that I have typed.
  1295.  
  1296.     NOTE!  To avoid confusion type your text files without any of the
  1297.     color codes in them.  When they are just the way you want
  1298.     them add color codes after first making a backup copy of the
  1299.     plain version.
  1300.  
  1301.     Note that the color codes ONLY affect the line on which they
  1302.     appear.  The beginning of each line is reset to the Normal
  1303.     (default) color for that palette, even if the ` or `DPK symbols
  1304.     were not used at the end of the line.  To have multiple lines
  1305. Page 23
  1306. ----------------------------------------------------------------------
  1307.  
  1308.     with the same color your will need to repeat the code on each
  1309.     line.  Example:
  1310.  
  1311.               `LYBThis is my first line of text
  1312.               `LYBMy second line starts here
  1313.  
  1314.  
  1315.     The lone ` symbol to toggle between normal and bold has been
  1316.     retained for backward compatibility with earlier versions of
  1317.     Catalog-On-A-Disk.  We do not recommend their use because
  1318.     of possible confusion.  For example:
  1319.  
  1320.                                 HOW `DRY I AM!
  1321.  
  1322.     In the above example you would expect "DRY" to appear in
  1323.     the bold color.  Instead, the word "DRY" would disappear, and
  1324.     "I am!" would appear in Dark Red on a Yellow (brown)
  1325.     background.  While this is an unlikely example it illustrates
  1326.     problems that can occur with older catalog files.
  1327.  
  1328.     Color codes can be used in Catalog (.TXT) files, Forms (.FRM)
  1329.     files, Screen (.CAT) files, or menu (.TL) files, and on some
  1330.     lines in CATALOG.CTF.  A rule of thumb is that they will
  1331.     probably work unless placed in the title that appears on the
  1332.     top border of a window.
  1333.  
  1334.     Macros:
  1335.  
  1336.     Internal Macros, when inserted into a catalog file, cause
  1337.     information about the catalog to be displayed.  You can
  1338.     display the date, any address line, or the number of printer
  1339.     lines in .CAT and .TXT files.  These macros will work
  1340.     anywhere in a .CAT file, and in the Long Descriptions ONLY
  1341.     in .TXT files.  Macros are:
  1342.  
  1343.     `XA# Show an address line *
  1344.     `XDK Show the date
  1345.     `XPK Show the number of printer lines (set with catalog -l#)
  1346.     `XXK Catalog Expiration Date
  1347.  
  1348.     *Replace the # with the number of the address line you want
  1349.     to show.  Use 1-9, or : for 10, ; for 11, or < for 12.
  1350.  
  1351.     When using macros leave enough space for the information to
  1352.     show up in your file.  Since you don't usually know how long
  1353.     an address line will be (because it depends on text your
  1354.     customer enters) it is good practice not to put text to the right
  1355.     of the `XA# macro.
  1356.  
  1357.     NOTE:  These macro translations appear on the screen
  1358.     ONLY.  For a list of macros used on the order form see the
  1359.     section on setting up the order form.
  1360.  
  1361. Page 24
  1362. ----------------------------------------------------------------------
  1363.  
  1364.     Command Files
  1365.  
  1366.     You can run programs from the catalog reader with command
  1367.     files.  Command files use the .CMD extension, and are similar
  1368.     to batch files.  When called command files are executed one
  1369.     line at a time.
  1370.  
  1371.     You can have two versions of each command file.  The name
  1372.     of the second version ends with the letter "M" and it is called
  1373.     instead of the original if catalog was started with the
  1374.     monochrome (-m) flag.  For example you could have a pair of
  1375.     command files called MYCMD.CMD and MYCMDM.CMD.
  1376.  
  1377.     There are three reserved command file names.  If these files
  1378.     exist they are automatically run by the catalog.
  1379.  
  1380.     File Name Mono Version   Run When:
  1381.     BCMD.CMD  BCMDM.CMD      Before First Screen
  1382.     ACMD.CMD  ACMDM.CMD      After First Screen, Before menu
  1383.     ECMD.CMD  ECMDM.CMD      Exit chosen from Exit Menu
  1384.  
  1385.     You can pass paths in command files.  For example, if you are
  1386.     running a picture viewer from the same disk and directory
  1387.     the catalog reader is in you want to make sure it will be
  1388.     properly called even if the catalog is called from a different
  1389.     directory than it resides in.  You use %% to represent the
  1390.     "home" directory of the catalog.  This way it won't matter
  1391.     what disk or directory the customer puts your catalog on - it
  1392.     will always run properly.  Example: 
  1393.  
  1394.     %%catpcx %%mypic.pcx -c5
  1395.  
  1396.     Any command file can be attached to the main menu and
  1397.     submenus and to the special forms menu and submenus.  In
  1398.     your .TL or .FM files list the file name with the extension
  1399.     ".CMD" after the pipe symbol to indicate this is a command
  1400.     file.  Example: 
  1401.  
  1402.     See A Demo | demo.cmd
  1403.  
  1404.     Configuration Files
  1405.  
  1406.     Configuration files are compressed files that affect the way
  1407.     your catalog operates, but do not appear on the screen.  The
  1408.     text versions have the .CTF extension.
  1409.  
  1410.     CATALOG.CTF    Required  Internal Program Text
  1411.     CMHLP.CTF      Optional  Command line help
  1412.     EXTRA.CTF      Optional  Extra Questions for order
  1413.                              form
  1414.     MULTI.CTF      Optional  Discount Multiplier
  1415.                              configuration
  1416.     ORDERFRM.CTF   Required  The order form template
  1417.     TOTAL.CTF      Required  Tax, shipping handling
  1418. Page 25
  1419. ----------------------------------------------------------------------
  1420.     
  1421.     Dealer Discounts
  1422.  
  1423.     If you want to use the same catalog for wholesale and retail
  1424.     customers you can do it using the Dealer Discount feature. 
  1425.     This feature lets you include a code number file that tells the
  1426.     catalog to apply a discount set by you.  If the file doesn't exist
  1427.     the retail prices will be applied.  This way you don't have to
  1428.     create separate catalogs with different prices.
  1429.  
  1430.     In CATALOG.CTF you can set up to 3 different discounts for
  1431.     your wholesale customers, special customers, or whomever.
  1432.  
  1433.     The first setting is on lines 152 and 153.  Line 152 has the
  1434.     code you will use, which can be any numbers, letters, or both. 
  1435.     Line 153 has the percent of the discount (the number 10 for
  1436.     ten percent, for example).  The second setting is on lines 154
  1437.     and 155, and the third on 156 and 157.  In each case the code
  1438.     word is on the even numbered line, and the discount percent
  1439.     on the following line.
  1440.  
  1441.     You should use code words that are not easy to figure out. 
  1442.  
  1443.     A small, one-line ASCII file enables a discount.  The file is
  1444.     called: DCTCODE.  This file is not compressed.  This is
  1445.     convenient, because if one of your customers has a copy of
  1446.     your catalog you can explain on the phone how to create the
  1447.     DCTCODE file to activate the discount (if you haven't already
  1448.     included the file on that disk).
  1449.  
  1450.     In the DCTCODE file you can type the same word that
  1451.     appears on line 152 of CATALOG.CTF to activate the first
  1452.     discount, match line 154 for the second, or line 156 to activate
  1453.     the third. 
  1454.  
  1455.     When a DCTCODE discount is enabled the following is true:
  1456.  
  1457.     NOTE!   The regular prices still show up in the catalog.  However,
  1458.     in the box where a product is ordered the discounted price is
  1459.     shown after the quantity is entered.  In addition, a message is
  1460.     displayed telling what discount is applied.
  1461.  
  1462.     NOTE!   If there is a MULTI.CM file those discounts are ignored. 
  1463.     Only the DCTCODE discount is used.
  1464.  
  1465.     NOTE!   If ordering from a discount pricing category, where there
  1466.     are more than one price depending on the number ordered,
  1467.     only the first price is used with the DCTCODE discount
  1468.     applied.  The logic is that the wholesale customer gets a fixed
  1469.     discount on a fixed price.
  1470.  
  1471.     NOTE!   When ordering from a category set up with the "choose"
  1472.     option, the discount is applied to the price the customer
  1473.     chooses, as you would expect.
  1474. Page 26
  1475. ----------------------------------------------------------------------
  1476.  
  1477.     Example:
  1478.  
  1479.     Lets say the first line of this excerpt from the catalog.ctf file
  1480.     begins on line 152:
  1481.  
  1482.     70426
  1483.     10
  1484.     DS402
  1485.     15
  1486.     Wholesale422
  1487.     40
  1488.  
  1489.     If the first line of DCTCODE says DS402 A 15% discount will
  1490.     be applied.
  1491.  
  1492.  
  1493.     Discount Multiplier
  1494.  
  1495.     Some businesses give customers an across the board discount
  1496.     that increases as the customer buys more.  You can set up
  1497.     your catalog to do this for up to three levels of discount.  To
  1498.     enable this feature you create a small ASCII file called
  1499.     MULTI.CTF.  For each discount level you type two numbers,
  1500.     separated by a single space.  The first number is the order
  1501.     total, and the second is the percent of the discount. 
  1502.  
  1503.     Here's an example file:
  1504.  
  1505.     20 5
  1506.     50 15
  1507.     100 20
  1508.  
  1509.     If the order is $50 or more and less than $100.00 a 15%
  1510.     discount is applied.
  1511.  
  1512.     NOTE!   Remember, you can have a maximum of three levels.  If
  1513.     the file contains more than three lines they will be ignored.  
  1514.  
  1515.     NOTE!   Make sure the levels progress from line one (lowest value)
  1516.     through line three(highest value.  Reversing lines 2 and 3
  1517.     could cause problems.
  1518.  
  1519.     Now compress the file.  If the compressed file is present the
  1520.     multiplier(s) are automatically used.  If not, the full price is
  1521.     charged for all totals.
  1522.  
  1523.     If you use this feature you should change the text on line 23
  1524.     of CATALOG.CTF to say that the discount is not included
  1525.     (this is for the review screen only).
  1526.  
  1527.     If you give different discounts to different customers you can
  1528.     use the same catalog for all customers, only changing the
  1529.     MULTI file for each one.
  1530.  
  1531. Page 27
  1532. ----------------------------------------------------------------------
  1533.  
  1534.     Exit Menu Screen (Catalog Insert)
  1535.  
  1536.     If text is present in catalog.ctf the following will appear
  1537.     on the Exit menu:
  1538.  
  1539.       Line 29 Print the order form to printer or screen
  1540.       Line 30 Review the order and delete items
  1541.       Line 31 Enter customer name and shipping address
  1542.       Line 32 Return to the main menu to order more products
  1543.       Line 33 Show Special Forms Menu (if CATALOG.FM is present)
  1544.       Line 34 Exit the program.
  1545.  
  1546.  
  1547.     Expired Prices
  1548.  
  1549.     Some companies only guarantee catalog prices through a
  1550.     specific date.  If you want your catalog can handle this. 
  1551.     Beginning on the expiration date a box pops up each time the
  1552.     catalog is started that warns the customer the prices may not
  1553.     still be in effect.  The customer is given the option to continue
  1554.     anyway.  This lets the customer know that he may be charged
  1555.     different prices without preventing him from ordering.
  1556.  
  1557.     The warning  message is on lines 79 and 80 in
  1558.     CATALOG.CTF.  Recommended text: "Warning!  Prices in this
  1559.     catalog may be out of date.  Please call 555-5555 for a new
  1560.     Catalog.  Continue? [n]"  (The "[n]" means that pressing [ENTER]
  1561.     is like typing N for no.  Y lets the customer continue.
  1562.  
  1563.     The expiration date is stored on line 78 of CATALOG.CTF.  It
  1564.     must be entered in this format:  MM-DD-YYYY
  1565.  
  1566.     If you do not want to use this feature simply enter a date that
  1567.     is very far in the future such as "01-01-2999".
  1568.  
  1569.     First Screens (Catalog Cover)
  1570.  
  1571.     The First Screen file is the first thing your customer sees
  1572.     when starting the catalog reader.  It is usually used as a
  1573.     "splash screen," containing your company's name, and telling 
  1574.     a little about the catalog before the customer begins ordering.  
  1575.     The top line of the FIRST file should be blank, or if you also
  1576.     want it on a menu you can put the menu text on the top line
  1577.     as you would in a category (TXT) file.  From there use 23
  1578.     lines for each screen.  You may use color codes and macros.
  1579.  
  1580.     NOTE!   The file must be called "FIRST.CAT" and must be
  1581.     compressed.
  1582.  
  1583. Page 28
  1584. ----------------------------------------------------------------------
  1585.  
  1586.     Freight
  1587.  
  1588.     You can attach a freight charge to any product in your
  1589.     catalog.  This is multiplied by the number of that item
  1590.     ordered, and kept in a separate subtotal that is included in
  1591.     the final total on the order form.  It is usually used for large
  1592.     items that require a freight charge beyond the normal
  1593.     shipping/handling cost.
  1594.  
  1595.     The first line of a product block has a tilde (~), order number,
  1596.     short description, and price.  After the price add a piping
  1597.     symbol (vertical line |), a space, another piping symbol, then
  1598.     the freight charge.  Use only numbers and decimal point.  Do
  1599.     not use a currency character.  Example:
  1600.  
  1601.     ~14882-A102  Professional Tripod          39.79 |  | 5.49
  1602.  
  1603.     Help Screens
  1604.  
  1605.     Your catalog displays a help screen when the customer
  1606.     presses f.  Minimally you must have one help file
  1607.     (CMOSHLP.CAT).  If you include more than one you get
  1608.     context sensitive help.  When creating a help screen leave the
  1609.     top line blank.  You can follow this with up to 500 lines of
  1610.     text.  If you think you might want to put the help file on a
  1611.     menu (for instance you could have a submenu that has all the
  1612.     help files on it) type the text for the menu on the top line. 
  1613.     Here is a list of help files and where they appear:
  1614.  
  1615.     CMOSHLP.CAT    General Help
  1616.     MMNUHLP.CAT    Help for Main Menu
  1617.     CMNUHLP.CAT    Category Menu Help
  1618.     EMNUHLP.CAT    Exit Menu Help
  1619.     PRNTHLP.CAT    Print Order Form Menu
  1620.     FINDHLP.CAT    Search Function
  1621.     CRVWHLP.TXT    Review Order Screen Help
  1622.     CMHLP.CTF      Command line help ("catalog -h")
  1623.  
  1624.     Information Screen
  1625.  
  1626.     The information screen is called when the customer presses
  1627.     [Alt] [I] (it can also be a menu choice).  This is a single screen 
  1628.     that shows vital information about your company and catalog. 
  1629.     You should be sure to put your customer service information
  1630.     here, especially your telephone number.  The text for this
  1631.     screen is on lines 181-200 in CATALOG.CTF.
  1632.  
  1633.     Pressing [Alt] [I] a second time pops up an "about box" with
  1634.     Catalog-On-A-Disk information.  You do not have to document
  1635.     this "secret" keystroke.
  1636.  
  1637.     Last and Special Orders
  1638.  
  1639.     You can set up the catalog reader to add products to the
  1640.     current ordering session when the customer chooses to do so.
  1641. Page 29
  1642. ----------------------------------------------------------------------
  1643.  
  1644.     There are two ways to do this.  The first adds the products
  1645.     that were ordered the last time an order form was printed. 
  1646.     This lets the customer order the same items again.  The
  1647.     second method lets the customer add a special order of
  1648.     products predetermined by you.  This could be any selection of
  1649.     products you want.
  1650.  
  1651.     To activate the Last Order feature, simply add a line to a .TL
  1652.     file with the menu choice followed by a piping symbol
  1653.     (vertical line |) and LASTORD.CIC.  Example:
  1654.  
  1655.     Add Last Order | LASTORD.CIC
  1656.  
  1657.     There are two steps to setting up a standard order.  First you
  1658.     must create the standard order file.  To do this set up the
  1659.     Last Order option as described above.   Order products from
  1660.     the catalog as if you were a customer.  Now print an order
  1661.     form, and exit the catalog.  You will find a file called
  1662.     LASTORD (the file name has no extension.)  Rename this file
  1663.     to STRDORD.
  1664.  
  1665.     The second step is to put the standard order option on the
  1666.     menu.  Add a line to the .TL file with the menu text, a piping
  1667.     symbol, and STRDORD.CIC.  Example:
  1668.  
  1669.     Special Just For You! | STRDORD.CIC
  1670.  
  1671.  
  1672.     Menus, Submenus
  1673.  
  1674.     Menus:
  1675.  
  1676.     The main menu can hold 500 items.  If you want more items,
  1677.     or if you want to organize your catalog in an hierarchal
  1678.     structure you may use sub-menus.
  1679.  
  1680.     Menu files are text files (they are not compressed), and they
  1681.     always have the extension ".TL" (".FM" for special forms
  1682.     menus).  The main menu must be called CATALOG.TL
  1683.     (CATALOG.FM for special forms).  Beyond that you can use
  1684.     any name for a submenu as long as it has the correct file
  1685.     extension.
  1686.  
  1687.     Each line in a menu file represents one choice on the menu. 
  1688.     The line contains two or three sections divided by a vertical
  1689.     line (|):
  1690.  
  1691.     Menu Text | File or Command Code | Disk Number
  1692.  
  1693.     Menu Text is what the customer actually sees on the menu.  It
  1694.     is required.
  1695. Page 30
  1696. ----------------------------------------------------------------------
  1697.  
  1698.     File Command or Code tells the catalog what file to display or
  1699.     action to perform.  This part is also required.  See the next
  1700.     section for an explanation.
  1701.  
  1702.     Disk Number is optional.  It is used for multi disk catalogs
  1703.     only.  If a file can't be found the catalog prompts the customer
  1704.     to insert another disk.  If you have indicated a Disk Number
  1705.     in the menu file it will specify which disk contains that file. 
  1706.     If no number is in the menu file the catalog defaults to 1.
  1707.  
  1708.     Sub-Menus:
  1709.  
  1710.     To go to a submenu you must add a line in your menu file. 
  1711.     Lets say you have a clothing catalog and you want a separate
  1712.     sub-menu for shirts.  You have named it "SHIRTS.TL."  To
  1713.     get there from the main menu add  this line to your
  1714.     CATALOG.TL file:
  1715.  
  1716.     Shirts | SHIRTS.TL
  1717.  
  1718.     The first part of the line is the text that appears on the menu. 
  1719.     After the piping symbol (vertical line) is the name of the
  1720.     menu file.
  1721.  
  1722.     If you want to return to the previous menu use a special key
  1723.     word ("BACK.TL") instead of the name of the menu file. 
  1724.     Continuing the above example, to return to the main menu
  1725.     add this line to shirts.tl:
  1726.  
  1727.     Previous menu | BACK.TL
  1728.  
  1729.     In any submenu you can always return to the main menu by
  1730.     calling it explicitly.  Example:
  1731.  
  1732.     Main Menu | CATALOG.TL
  1733.  
  1734.     You can have more than one of these choices in a single
  1735.     menu.  Example:
  1736.  
  1737.     Jerseys | JSH.TL
  1738.     Oxford Shirts |OSH.TL
  1739.     T-Shirts | TSH.TL
  1740.     Previous menu | BACK.TL
  1741.     Main Menu | CATALOG.TL
  1742.  
  1743.     Basic Catalog-On-A-Disk supports a maximum of two levels of
  1744.     submenu.  If you try to call more than two levels an error
  1745.     message is displayed and you are returned to the main menu. 
  1746.     This does NOT mean the number of sub-menus is limited.
  1747.  
  1748.     A "level" is the number of menus you have traversed to get to
  1749.     the current sub-menu.  The following chart illustrates menu
  1750.     levels:
  1751. Page 31
  1752. ----------------------------------------------------------------------
  1753.  
  1754.     Level 1              Level 2
  1755.  
  1756.     CATALOG.TL---  |SHIRTS.TL
  1757.                    |PANTS.TL
  1758.                    |SOCKS.TL
  1759.  
  1760.  
  1761.     NOTE!  Include copies of all Menu Files on all the disks in a
  1762.     multi-disk catalog.
  1763.  
  1764.     File Command or Code:
  1765.  
  1766.     While the text that appears in this section of a menu line
  1767.     always looks like a DOS file name (up to eight characters for
  1768.     the name, and a dot followed by a one to three letter
  1769.     extension), the names in a menu file do not necessarily refer
  1770.     to actual files.  Most catalog files are compressed and have
  1771.     the .CM extension.  Menu files distinguish between the types
  1772.     of files as follows:
  1773.  
  1774.     .CM  Category file.  (Text version uses .TXT)
  1775.     .CAT Screen file.  (Text version uses .CAT)
  1776.     .CMD Command files run other programs from the menu.
  1777.     .TL  Menu Files (Main menu only)
  1778.     .FM  Menu Files (Forms Menu Only)
  1779.     .CIC Catalog Internal Commands
  1780.  
  1781.     Catalog Internal Commands:
  1782.  
  1783.     Catalog Internal Commands allow you to put program actions
  1784.     on menus.  Reserved keywords are used for this purpose.  You
  1785.     should never give a catalog file the same name as one of
  1786.     these words.
  1787.  
  1788.     LASTORD.CIC    If this is on the main menu the order is
  1789.                    saved to disk when the order form is
  1790.                    printed.  This allows the customer to
  1791.                    import the last order into the current
  1792.                    session.
  1793.     STRDORD.CIC    You may provide a standard order file
  1794.                    containing selected products.  This choice
  1795.                    imports those products into the current
  1796.                    session.
  1797.     PRINTER.CIC    Print the entire catalog.
  1798.     EXITMEN.CIC    Go to the Exit Menu (  do not use this
  1799.                    command in .FM menus)
  1800.     INFOSCRN.CIC   Display the Information screen.
  1801.  
  1802.     Headers:
  1803.  
  1804.     The text that appears on the screen with each menu is
  1805.     contained in a "Header File."  You create a file called
  1806.     "HEADER.CAT" and the compressed version is displayed next
  1807.     to your main menu.
  1808. Page 32
  1809. ----------------------------------------------------------------------
  1810.  
  1811.     If you are using sub-menus you can have a different "Header
  1812.     File" for each menu.  Simply create a text file that has the
  1813.     same name as the menu file (.TL), but with the extension
  1814.     ".CAT".  For example, if your submenu file is called SUB1.TL
  1815.     the sub-header file for that menu should be called SUB1.CAT. 
  1816.     Compress the file and include SUB1.CM on your catalog disk.
  1817.  
  1818.     If a sub-header file exists it is displayed with the submenu it
  1819.     shares a name with.  If there is no sub-header for a sub-menu
  1820.     the main header will be shown (if it exists).
  1821.  
  1822.     Header files are used with Main Menu screens only - do not
  1823.     try to use them with the Special Forms menu.
  1824.  
  1825.  
  1826.     Multi-Disk Catalogs
  1827.  
  1828.     If your catalog is too big to fit on one disk you can use more
  1829.     than one.  We suggest recommending that your customers
  1830.     copy a multi-disk catalog to a hard drive, because continually
  1831.     changing disks can be annoying.  Some customers will not
  1832.     want the catalog on their hard drive, so this gives them a way
  1833.     to use it from floppies.
  1834.  
  1835.     CATALOG.EXE, CATALOG.CM, and CATALOG.INI, order
  1836.     form and configuration files must be on disk 1.  When
  1837.     entering the Exit menu the program looks for itself to insure
  1838.     it is on the same disk as the configuration files needed to
  1839.     print the order form.
  1840.  
  1841.     Certain files should go on each disk.  These include the help
  1842.     files, menu files (if there is more than one menu),  CMD files
  1843.     and any utilities that are run by those CMD files.
  1844.  
  1845.     Order Form
  1846.  
  1847.     The order form is controlled by three configuration (.CTF)
  1848.     files.
  1849.  
  1850.     EXTRA.CTF      (Optional)  Contains extra questions you
  1851.                    need answered as part of the order (such
  1852.                    as credit card number and expiration
  1853.                    date).    See Asking Extra Order
  1854.                    Form Questions
  1855.  
  1856.     ORDERFRM.CTF   (Required) Contains your template
  1857.                    design for the form.    See Order Form
  1858.                    Template
  1859. Page 33
  1860. ----------------------------------------------------------------------
  1861.  
  1862.     TOTAL.CTF      (Optional)  Contains shipping/handling
  1863.                    setup, tax rates and match text,
  1864.                    additional shipping setup.    See
  1865.                    Shipping    Also see Taxes
  1866.  
  1867.     Order Form Template
  1868.  
  1869.     The design for the order form is kept in a file called
  1870.     ORDERFRM.CTF.  This file is a template for the order form. 
  1871.     It consists of free form text that you devise, plus macros.  
  1872.     Each macro represents a type of data such as the date,
  1873.     shipping address,  and so on.  When your customer orders the
  1874.     macros are replaced by the actual data from their order.  If
  1875.     you look at the sample provided you will notice that it looks
  1876.     very much like a finished order form.
  1877.  
  1878.     You should try to keep the number of lines on the form to as
  1879.     few as possible.  Remember the order form is for you to get
  1880.     the information you need, so don't clutter it with a lot of
  1881.     information that could be elsewhere in the catalog.  However,
  1882.     you can put anything you need on the form.  Take a look at
  1883.     catalogs you receive in the mail for typical order form layouts.
  1884.  
  1885.     Any free form text will be printed where you place it on the
  1886.     form.  When macros are inserted into the text be sure to leave
  1887.     room for the largest string of replacement text you anticipate.  
  1888.     For example, if the shipping code follows the date, make sure
  1889.     you leave plenty of room for the largest possible date string
  1890.     (November 27, 1997) before placing the next text or macro.
  1891.  
  1892.     There are two types of macro.  The first kind is simply
  1893.     inserted in the form to interact with the text.  The second
  1894.     takes a whole line to insert special sections into the form (like
  1895.     the answers to the special questions from EXTRA.CTF).  
  1896.  
  1897.     These macros can be inserted anywhere in the form:
  1898.  
  1899.     `XA1 Address line 1
  1900.     `XA2 Address line 2
  1901.     `XA3 Address line 3
  1902.     `XA4 Address line 4
  1903.     `XA5 Address line 5
  1904.     `XA6 Address line 6
  1905.     `XA7 Address line 7
  1906.     `XA8 Address line 8
  1907.     `XA9 Address line 9
  1908.     `XA: Address line 10
  1909.     `XA; Address line 11
  1910.     `XA< Address line 12
  1911.  
  1912.     `XDK Date
  1913. Page 34
  1914. ----------------------------------------------------------------------
  1915.  
  1916.     `SCK Shipping Code (First 2 letters of shipping text chosen
  1917.          when customer is asked to pick a shipping option. 
  1918.          Example:  If the text is "Priority Mail   $4.00" the
  1919.          shipping code will be PR.)
  1920.  
  1921.     `SFK Full shipping string chosen by customer.
  1922.  
  1923.     `XCK City, State ZIP (This macro prints the city line and the
  1924.          two lines following it in standard format.  This way
  1925.          you don't have to know in advance how long the text
  1926.          for each will be.)
  1927.  
  1928.     `XBK Brand Message (The brand is printed at the end of the
  1929.          order form unless you include it elsewhere on the form
  1930.          with this macro.  Notice on our sample order form it is
  1931.          near the top.)
  1932.  
  1933.     `SPK Space to bottom.  (Anything following this macro will
  1934.          be printed at the bottom of the page.  This way you can
  1935.          have text that always appears at the bottom, no matter
  1936.          how many products were ordered.   The macro should
  1937.          be the first thing on a line, but you may have other
  1938.          text after it that is printed.)
  1939.  
  1940.  
  1941.     These macros begin a line - nothing else (except optional
  1942.     notes that are not printed) goes on the line with them.
  1943.  
  1944.     `EQK Extra Question answers (Inserts the answers to the
  1945.          Special Questions if you included the EXTRA.CTF file.)
  1946.          NOTE!  Must not be used above `OMK macro.
  1947.  
  1948.     `UNK  The Salesman code (if a Uniquel file is used)
  1949.  
  1950.     `XSK Salesman commission (if enabled) 
  1951.  
  1952.     `XFK File name  (If saving to a file its name can be printed
  1953.          on the form to use as an order reference.  This only
  1954.          appears in files - it is ignored when printing to the
  1955.          printer.)
  1956.  
  1957.     `OMK There is one special macro of the second type that
  1958.          takes three lines instead of one.  The `OMK macro is
  1959.          used to set the tab stops for the detail and totals
  1960.          sections of the order form.
  1961.  
  1962.          First Line:  Place the `OMK macro at the beginning of
  1963.          the line, optionally followed by notes that are not
  1964.          printed or the actual form.
  1965.  
  1966.          Second Line:  Tab settings define the spacing for the
  1967.          detail order section (order number, description,
  1968.          quantity ordered, price, etc.) where each product is
  1969.          listed.   If this line is blank the detail section will not
  1970.          print.  
  1971. Page 35
  1972. ----------------------------------------------------------------------
  1973.     
  1974.          Put the code where you want the data to appear on the
  1975.          real order form.  If you want the information to justify
  1976.          on the right or left, add R or L right after the code
  1977.          (Example: NR).  If you want the default you only need
  1978.          the single letter code.
  1979.  
  1980.  
  1981.          Code Meaning             Default Justification
  1982.     
  1983.               #    The count of items ( 1.) Right
  1984.          N    The item's order number  Left
  1985.          D    Short Description        Left
  1986.          Q    Quantity ordered         Right
  1987.          P    Unit Price               Right
  1988.          T    Subtotal for that item   Right
  1989.          X    End of short description Right
  1990.  
  1991.          If a code on lines 2 or 3 does not exist that information
  1992.          will not be printed.
  1993.  
  1994.          Line 3:  Use this line to set the tabs for the totals
  1995.          section (Subtotal:, Sales Tax:, etc.) .  Two codes are
  1996.          used to set the position of the headings and of the
  1997.          subtotal or total price: 
  1998.  
  1999.          :    Heading                            Right
  2000.          T    Total price              Right
  2001.  
  2002.  
  2003.     Pricing
  2004.  
  2005.  
  2006.     For most applications you want CATALOG-ON-A-DISK to
  2007.     multiply the price of each item by the quantity ordered, and
  2008.     add this sum to the total order.  To use this "normal" pricing
  2009.     option type the word "NORMAL" (upper case required) on line
  2010.     142 of CATALOG.CTF, and recompress the file.  (NOTE:
  2011.     CATALOG-ON-A-DISK ships with this option enabled, so if
  2012.     you haven't changed this line you do not have to do anything.)
  2013.  
  2014.     You can set CATALOG.EXE to simply count items, and
  2015.     multiply the quantity by a single price.  This might be useful
  2016.     in a shareware business where all the disks cost the same,
  2017.     but some programs are on multiple disks.  Instead of prices
  2018.     you would type the number of disks per product in the
  2019.     category files.  Then, to enable this pricing option, type
  2020.     "COUNTUP 4.95" (upper case required) on line 142 of
  2021.     CATALOG.CTF, and recompress the file.  Replace "4.95" with
  2022.     your own disk price.
  2023. Page 36
  2024. ----------------------------------------------------------------------
  2025.  
  2026.     Finally, you can set CATALOG.EXE to not use prices.  This is
  2027.     useful when you are using the program to generate requests
  2028.     for estimates.  The customer goes through the catalog as
  2029.     usual, "orders" products and prints an order form.  This is
  2030.     sent to the company, and returned with the estimate for those
  2031.     products.  To set this option type "NOPRICE" (upper case
  2032.     required) on line 142 of CATALOG.CTF, and recompress the
  2033.     file.   If using this option you should leave off the P and S
  2034.     codes (Unit Price and Unit Subtotal) on the order form and
  2035.     review screen.
  2036.  
  2037.     NOTE!  Note that these are GLOBAL pricing options.  This means
  2038.     that they affect all categories in your catalog.  You can't use
  2039.     NORMAL for one category and NOPRICE for another, for
  2040.     example.
  2041.  
  2042.     note!  Some countries use a comma instead of a decimal point in
  2043.     listing prices.  This will work if the Catalog is set to
  2044.     International in CATCOM.  It is important to note that prices
  2045.     must be numbers and decimal point (or comma) only.  No
  2046.     currency symbol should be used, and no separator should be
  2047.     used.  
  2048.  
  2049.     Good Examples: 1500.95   1500,95
  2050.     BAD Examples:  1,500.95  1.500,95
  2051.  
  2052.     Printer
  2053.  
  2054.     CATALOG.EXE doesn't use any special printer codes to print
  2055.     the catalog, order form, and so on.  This insures that orders
  2056.     can be printed on any printer.
  2057.  
  2058.     Some printing uses a setting that determines the number of
  2059.     lines on a page.  This setting can be set by the customer, and
  2060.     should be one less that the total number of lines the printer
  2061.     can print on a page.  For example, a Hewlett Packard
  2062.     LaserJet II prints 60 lines per page, so the catalog should be
  2063.     set to 59 (59 is the default setting).
  2064.  
  2065.     You set this number using the -l# (replace '#' with the actual
  2066.     number) flag when starting CATALOG.EXE.  This need only
  2067.     be done one time - the catalog remembers the setting. 
  2068.     Example (to set to 65 lines):
  2069.  
  2070.                        CATALOG -L65 [ENTER]
  2071.  
  2072.     Other printer considerations:
  2073.  
  2074.     NOTE!   Upper ASCII characters may not print as expected on all
  2075.     printers.  If the look of the print out is very important avoid
  2076.     using the box and other upper ASCII characters in the
  2077.     material to be printed.  This will limit some screen designs.
  2078.  
  2079. Page 37
  2080. ----------------------------------------------------------------------
  2081.  
  2082.     Print Order Form Menu
  2083.  
  2084.     You can have from 1 - 6 items on the Print menu.  Each
  2085.     starts with a number (which must be the left-most character
  2086.     with no spaces before it), followed by the text (contained in
  2087.     CATALOG.CTF lines 15 - 21). 
  2088.  
  2089.     Example: 
  2090.  
  2091.     1Print Order Form
  2092.     2Save Order To A File
  2093.  
  2094.  
  2095.     1    LPT1
  2096.     2    LPT2
  2097.     3    COM1
  2098.     4    COM2
  2099.     5    Write order form to a file, prompt user for file name. 
  2100.          You may type in a port name to direct the order to that
  2101.          port.
  2102.     6    Catsend (only used if enabled and present).
  2103.  
  2104.     NOTE!   If there are no good entries LPT1 is used as the default,
  2105.     and is instantly acted upon.
  2106.  
  2107.     NOTE!   If there is only ONE entry the menu is skipped, and that
  2108.     choice is instantly acted upon.
  2109.  
  2110.     NOTE!   Menu Text should be 56 characters or less.
  2111.  
  2112.     Program Prompts
  2113.  
  2114.     Line 160 of catalog.ctf contains "hot key" letters for various
  2115.     choices.  These can be changed if you are making a
  2116.     non-English Catalog:
  2117.  
  2118.     y    yes
  2119.     n    no
  2120.     r    reorder
  2121.     b    reserved
  2122.     h    reserved
  2123.     n    next
  2124.     h    help
  2125.     m    mono
  2126.     l    lines per page
  2127.     a    reserved
  2128.  
  2129.     In addition, each alt key combination has a Function Key
  2130.     alternative.  They are as follows:
  2131.  
  2132.     [Alt] [H]  [Alt] [F1]     help bar toggle
  2133.     [Alt] [S]  [F2]           search
  2134.     [Alt] [N]  [[Alt] [F2]    next search
  2135.     [Alt] [I]  [F4]           information screen
  2136.     [Alt] [X]  [F10]          exit to DOS
  2137. Page 38
  2138. ----------------------------------------------------------------------
  2139.     
  2140.     Program Text
  2141.  
  2142.     The file CATALOG.CTF contains all the internal program text
  2143.     for CATALOG.EXE, plus a some of the configuration setup
  2144.     information.  Each line in this file is used for a specific
  2145.     purpose.  You will find an explanation of each line in the file
  2146.     CATTXT.DOC.  It is very important that you do not put text
  2147.     on the wrong line in this file.  You should print a copy of the
  2148.     CATTXT.DOC file and refer to it whenever you edit
  2149.     CATALOG.CTF.  Always keep a good copy of the file on hand
  2150.     in case your working version develops problems.
  2151.  
  2152.     Review Screen
  2153.  
  2154.     The setup for the review screen is found in CATALOG.CTF. 
  2155.     For a full listing of all the lines used see CATTXT.DOC.  
  2156.  
  2157.     Some of the most important lines to set are the two header
  2158.     lines (21,22) which set the headings at the top of the screen,
  2159.     and the tabs line (26) that sets the spacing of the information
  2160.     for each product ordered.
  2161.  
  2162.     Tabs are set using special codes for each kind of information. 
  2163.     Put the code where you want the data to appear on the screen
  2164.     (remember a screen is 78 characters wide).  If you want the
  2165.     information to justify on the right or left, add R or L right
  2166.     after the code (Example: NR).  If you want the default you
  2167.     only need the single letter code.  If a code is not used that
  2168.     information will not be printed.
  2169.  
  2170.  
  2171.  
  2172.          Code Meaning             Default Justification
  2173.  
  2174.          #    The count of items ( 1.) Right
  2175.          N    The item's order number  Left
  2176.          D    Short Description        Left
  2177.          Q    Quantity ordered         Right
  2178.          P    Unit Price               Right
  2179.          T    Subtotal for that item   Right
  2180.          X    End of short description Right
  2181.  
  2182.  
  2183.     Screen Files
  2184.  
  2185.     A Screen File is a file that does not contain product or other
  2186.     blocks that is shown on the screen.  The most common
  2187. Page 39
  2188. ----------------------------------------------------------------------
  2189.  
  2190.     examples of screen files are the FIRST.CAT and
  2191.     HEADER.CAT files.  You can put other screen files on your
  2192.     menus that contain up to a maximum of 500 lines of text.
  2193.  
  2194.     The top line of the file should start with the text you want to
  2195.     appear on the menu so the customer can choose to view this
  2196.     file.  This is followed by a maximum of 500 lines of free form
  2197.     text which can contain color codes and macros.
  2198.  
  2199.     All screen files use the .CAT extension, and must be
  2200.     compressed before they will show up in your catalog.
  2201.  
  2202.  
  2203.     Security
  2204.  
  2205.     While there is no way to make a catalog completely secure
  2206.     from tampering, there are some special measure that have
  2207.     been taken to protect your catalog.  Most people are honest, 
  2208.     but it doesn't hurt to take some precautions.
  2209.  
  2210.     1.  The brand that you establish the first time you run the
  2211.     Setup program is embedded into a file along with your catalog
  2212.     setup flags.  It is used to check that the initialization file with
  2213.     your tax, address, and other configuration information is not
  2214.     tampered with.  If it has been altered the catalog won't run -
  2215.     it will display a message (contained on line 51 of catalog.ctf),
  2216.     and error #300.  (Registered copies only)  
  2217.  
  2218.     Note: We strongly suggest that the message you use does not
  2219.     accuse the customer of tampering.  You have no way of
  2220.     knowing whether someone gave this person a bad copy, and,
  2221.     in any event, it's bad customer relations.  Use a bland
  2222.     message like "Please Call For A New Catalog."  This way you
  2223.     know what is going on, but relations with the customer are
  2224.     kept on a cordial basis.
  2225.  
  2226.     2.  The compressed catalog files give your catalog a measure of
  2227.     security.  The only way customers can access pricing and
  2228.     other catalog data is by using the CATALOG.EXE program,
  2229.     which uncompresses the files directly into memory.  There is
  2230.     no text file on which prices or ordering information can be
  2231.     changed.
  2232.  
  2233.     3.  TXT and CAT files may be password protected.  While it is
  2234.     unlikely that anyone would be able to uncompress your
  2235.     catalog, CATCM.EXE will not uncompress a password
  2236.     protected file unless the correct password is entered.  (Do not
  2237.     forget your password!!!)
  2238.  
  2239.     Shipping
  2240.  
  2241.     When a customer prints an order form a menu pops up with
  2242.     shipping/handling options.  You can have up to 12 shipping
  2243. Page 40
  2244. ----------------------------------------------------------------------
  2245.  
  2246.     options on this menu.  Each takes one line in the
  2247.     configuration file TOTAL.CTF. 
  2248.  
  2249.     Shipping lines begin with the small letter s followed by the
  2250.     text to appear on the menu, a piping symbol (vertical line |),
  2251.     and the price.  The shipping options will appear in the same
  2252.     order on the menu as you enter them in the TOTAL.CTF file. 
  2253.     Example:
  2254.  
  2255.     s USPS (US)              3.00 | 3.00
  2256.     s USPS (Canada)          5.00 | 5.00
  2257.     s USPS (Elsewhere)       9.00 | 9.00
  2258.     s UPS Ground (US)        3.00 | 3.00
  2259.     s UPS BLUE (48 Sts)      6.00 | 6.00
  2260.     s UPS BLUE (AL HI PR)    8.00 | 8.00
  2261.     s UPS RED (US)           15.00 | 15.00
  2262.     s UPS RED (AL HI PR)     19.00 | 19.00
  2263.     s Customer Pick Up       0.00 |  0.00
  2264.  
  2265.     Some companies provide a blanket shipping cost for a
  2266.     specified number of items, and additional shipping per item
  2267.     after that number.  For example you might want to charge .50
  2268.     for each item ordered after the first five products.  To do this
  2269.     add a line in TOTAL.CTF that starts with the small letter a
  2270.     followed by the number of products covered by the blanket
  2271.     charge, a piping symbol, and the amount to add per-product. 
  2272.     Example:
  2273.  
  2274.     a 5 | .50
  2275.  
  2276.  
  2277.     Size Boxes
  2278.  
  2279.     Size Boxes let you ask about sizes, colors, etc. of products and
  2280.     add a code to the order number to tell which was chosen.  For
  2281.     example, in a category of shirts you may want to ask the size
  2282.     and color of each shirt ordered.
  2283.  
  2284.  
  2285.     Size box data is added to the end of the long description in a
  2286.     product block, and must be contained within the 500 line
  2287.     limit.  Each box can have up to 9 items.  There is no limit to
  2288.     the number of boxes you use except the 500 line limit.  You
  2289.     also want to be aware that a two character code is added to
  2290.     the order number for each box, so you should use the fewest
  2291.     possible, or the order number will get out of hand.
  2292.  
  2293.     Creating a Size Box is easy.  At the end of your long
  2294.     description begin the Size Box with 
  2295.  
  2296.     `SBXBoxTitle
  2297. Page 41
  2298. ----------------------------------------------------------------------
  2299.     
  2300.     note!  Replace "BoxTitle" with the real title you want to use.
  2301.  
  2302.     Each line after that is a choice of size, color, or whatever. 
  2303.     Example:
  2304.  
  2305.     `SBXShirt Sizes:
  2306.     Small
  2307.     Medium
  2308.     Large
  2309.     Extra Large
  2310.     `SBXColors:
  2311.     `LGBGreen
  2312.     `LWBBlue
  2313.     `LRBRed
  2314.     `LCBAqua
  2315.     `LWBWhite
  2316.  
  2317.     The above example has two Size Boxes.  After the customer 
  2318.     types in the quantity desired, the first box will pop up.  
  2319.     The choices are numbered, and the customer presses the 
  2320.     number of the choice desired.  Now the second box pops up.  
  2321.     The customer types the number for the color wanted, and is 
  2322.     returned to the quantity box.  At this point he can press 
  2323.     [ENTER] to accept, to [R] reorder, or [Esc] to abort.
  2324.  
  2325.     Lets say the customer chooses a shirt with an order number
  2326.     SH0005,  then picks "Medium" and "Blue" from the Size
  2327.     Boxes.  On the review screen and order form the order
  2328.     number will appear: SH0005-MEBL.
  2329.  
  2330.     You can also color the title of a Size Box.  The color code
  2331.     MUST come right after the Size Box Code and before the title
  2332.     text.  
  2333.  
  2334.     Example:
  2335.  
  2336.     `SBX`LYBBoxTitle
  2337.  
  2338.     Color codes can go anywhere on the other lines (that list the
  2339.     choices).
  2340.  
  2341. Page 42
  2342. ----------------------------------------------------------------------
  2343.  
  2344.     Special Forms
  2345.     
  2346.     You can add a Special Forms menu to your catalog.  If present
  2347.     this is accessed from the exit menu.  The base special forms
  2348.     menu is contained in CATALOG.FM, and its submenus have
  2349.     the .FM extension as well.  
  2350.  
  2351.     The special forms menu has most of the same features as the
  2352.     main menu.
  2353.  
  2354.  
  2355.     Taxes
  2356.  
  2357.     The catalog reader is flexible enough to handle many tax
  2358.     requirements, so that sales tax is calculated automatically on
  2359.     the order form.  Three settings in Catcom determine tax
  2360.     behavior, plus you can make a list of predetermined tax rates
  2361.     for various states, provinces or countries in the TOTAL.CTF
  2362.     file.  
  2363.  
  2364.     You can set up two separate taxes that match on different
  2365.     fields (province and country, for instance).  Since most
  2366.     localities require one sales tax you can ignore the settings for
  2367.     the second tax unless required to use it.
  2368.  
  2369.     Who To Tax
  2370.  
  2371.     Depending on your obligation you can use Catcom to set the
  2372.     catalog to add sales tax for one state or province, all states or
  2373.     provinces, or none.
  2374.  
  2375.     When the customer fills in his or her address CATALOG.EXE
  2376.     looks at the tax match line (see below) and tries to match it
  2377.     with a list set up in the TOTAL.CTF file.  If you have set
  2378.     your catalog to tax ONE state it will automatically fill in the
  2379.     tax (or pop up the tax box for the customer to fill in) if it finds
  2380.     a match.
  2381.  
  2382.     If you are not obligated to collect sales tax there is a simple
  2383.     trick to setting the catalog.  Choose "One State or Province"
  2384.     on this menu.  Then, in your TOTAL file define a nonsense
  2385.     state ("ghasgqfvs", for example) with a tax of 0.  Because
  2386.     there will never be a match the tax is never added.
  2387.  
  2388.     What To Tax 
  2389.  
  2390.     You also use Catcom to determine whether the tax will be
  2391.     applied to merchandise only, or to both merchandise and
  2392.     shipping/handling charges.
  2393. Page 43
  2394. ----------------------------------------------------------------------
  2395.  
  2396.     Tax Match
  2397.  
  2398.     The Tax Match line is the address (Name Box) line to try to
  2399.     match when automatically applying a sales tax to a specific
  2400.     locality.  For example, lets say you have set up your address
  2401.     fields so that field 1 is name, 2 and 3 are street address, 4 is
  2402.     city, 5 is state, and 6 is zip code.  You only want to charge
  2403.     sales tax in New York, so you choose line 5 for your Tax
  2404.     Match line.
  2405.  
  2406.     By doing this the catalog will look to see if the customer typed
  2407.     "NY" in the state field, and if it finds it the tax will be applied
  2408.     to the order.
  2409.  
  2410.     List of Taxes
  2411.  
  2412.     The text to match and tax rates are kept in the TOTAL.CTF
  2413.     file.  You can have as many listings as you want.  Each line
  2414.     starts with the small letter "t" (use "v" for the second tax if
  2415.     you need it) followed by the text to match, a piping symbol,
  2416.     and the tax rate.  Tax matches are not case sensitive, so you
  2417.     do not need separate lines for "NY" and "ny."  
  2418.  
  2419.     The following example matches the text "NY" and if it finds a
  2420.     match in the state field of the customer's address 7% is
  2421.     automatically added to the order total. 
  2422.  
  2423.     t NY | 7
  2424.  
  2425.     Actually, New York State has different tax rates for each
  2426.     county.  You can set the catalog to pop up a box asking for the
  2427.     correct tax rate whenever the state field has "NY" in it.  This
  2428.     is done by replacing the tax rate with the number "999." 
  2429.     Example:
  2430.  
  2431.     t NY | 999
  2432.  
  2433.     In the next example the first tax is charged when the
  2434.     province field matches on Ontario, and the second tax is
  2435.     charged when the country is blank or matches on Canada (notice
  2436.     the variations on "ON" that a customer might type):
  2437.  
  2438.     t ON | 999
  2439.     t ONT | 999
  2440.     t Ontario | 999
  2441.     v CANADA | 5.2
  2442. Page 44
  2443. ----------------------------------------------------------------------
  2444.  
  2445.     APPENDIX A: Program Limits
  2446.  
  2447.     Maximum Items on each Menu:             500
  2448.     Sub-Menu Levels:                        2
  2449.     Maximum Lines in Long Descriptions:     500
  2450.     Maximum lines in Screen Files:          500
  2451.     Maximum Products Ordered in 1 Session:  200
  2452.     Maximum Products in Category File:      *
  2453.  
  2454. *Dependent on amount of data - about 600 with no long descriptions.
  2455.  
  2456.